Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 1 - Appearance Manager Reference / Appearance Manager Functions

Initializing the Appearance Manager /

RegisterAppearanceClient

NEW WITH THE APPEARANCE MANAGER

Makes your application Appearance-compliant and enables the mapping of standard pre-Appearance definition functions to their Appearance-compliant equivalents.

pascal OSStatus RegisterAppearanceClient (void);

function result

A result code. The result code appearanceProcessRegisteredErr indicates that your process was already registered when you called the RegisterAppearanceClient function. For a list of other result codes, see "Result Codes".

DISCUSSION

The RegisterAppearanceClient function must be called at the beginning of your application, prior to initializing or drawing any onscreen elements or invoking any definition functions, such as the menu bar. Under Appearance 1.0 and 1.0.1, applications that call RegisterAppearanceClient will continue to have a platinum look when systemwide appearance is off.

RegisterAppearanceClient automatically maps standard pre-Appearance definition functions to their Appearance-compliant equivalents, whether or not the user has turned on systemwide appearance; see "Introduction to the Appearance Manager" for more details on this process. Although they will not make use of mapping, applications that specify Appearance-compliant definition function IDs directly should also call RegisterAppearanceClient.